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Typographical Conventions 


The typefaces used in this manual, summarized below, emphasize important 
concepts. All references to filenames and commands are case-sensitive and should 


be typed accurately. 
Kind of Text 


Body text; italicized for emphasis, new 
terms, and book titles 


Environment variables, filenames, 
functions, methods, options, parameter 
names, path names, commands, and 
computer data 


Commands that need to be highlighted 
within bodytext, or commands that must be 
typed as is by the user are bolded. 


Text that represents a variable, such as a 
filename or a value that must be entered by 
the user, is italicized. 


Blocks of text that appear on the display 
screen after entering instructions or 
commands 


Keyboard options, button names, and menu 
sequences 


Examples 


Refer to the LynxOS-178 v2.2.4 BETA 
Installation Guide 


ls -l myprog.c /dev/null 


login: myname 
# cd /usr/home 


cat <filename> 
mv <filel> <file2> 


Loading file /tftpboot/shell.kdi into 
0x4000 


2015 Lynx Software Technologies, 
. All rights reserved. 


Enter, Ctrl-c 


LynxOS-178 v2.2.4 BETA Installation Guide 1 


Preface 


LynxOS-178 v2.2.4 BETA Documentation Set 
The LynxOS-178 v2.2.4 BETA Documentation Set includes the following: 


¢  LynxOS-178 v2.2.4 BETA Release Notes 

+ LynxOS-178 v2.2.4 BETA Installation Guide 

¢ LynxOS-178 v2.2.4 BETA Advanced Porting Kit Guide 

* LynxOS-178 v2.2.4 BETA T2080RDB Board Support Guide 
*  LynxOS-178 v2.2.4 BETA P3041RDB Board Support Guide 
+ Lynx Certifiable Stack v2.0.1 User's Guide 

+ Lynx Certifiable Stack v2.0.1 Release Notes 

* LOCI v5.1.1 BETA Release Notes 

* SpyKer v5.1.1 BETA Release Notes 

* Luminosity v5.1.1 BETA Release Notes 


Additional documents from the LynxOS-178 v2.2.3 commercial release have been 
included in this release when applicable. 
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Technical Support 


Lynx Software Technologies handles support requests from current support 

_ subscribers. For questions regarding Lynx Software Technologies products, 
evaluation CDs, or to become a support subscriber; our knowledgeable sales staff 
will be pleased to help you. Please visit us at: 


http: //www.lynx.com/corporate/contact/support .php3 


How to Submit a Support Request 


When you are ready to submit a support request, please include all of the following 
information: 


* First name 

+ Last name 

* Your job title 

* Phone number 

* Fax number 

+ E-mail address 

* Company name 

+ Address 

+ City, State, ZIP 

+ Country 

+ LynxOS version number [LynxOS-178 v2.2.4 BETA] 

+ Target Platform (for example, PowerPC) 

+ Board Support Package (BSP) 

* Current Service Pack Revision 

+ Development Host OS version 

* Detailed description of the problem that you are experiencing: 
-  Isthere a requirement for a US Citizen to work on this issue? 
- Priority of the problem — Critical, High, Medium, or Low? 


- Test Cases or Log Files that substantiate or elaborate the problem? 
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Where to Submit a Support Request 


By E-mail: 
Support, Europe tech_europe@lynx.com 
Support, worldwide except Europe support@lynx.com 
Training and Courses USA: training-usa@lynx.com 
Europe: training-europe@lynx.com 
By Phone: 


Training and courses 


USA: +1 408-979-4353 
Europe: +33 1 30 85 06 00 


Support, Europe 
(from our Paris, France office) 


+33 130 85 93 96 


Support, worldwide except Europe and Japan 
(from our San José, CA, USA headquarters) 


+1 800-327-5969 or 
+1 408-979-3940 


Support, Japan 


+81 33 449 3131 


By Fax: 


Support, Europe 
(from our Paris, France office) 


+33 1 30 85 06 06 


Support, worldwide except Europe and Japan 
(from our San José, CA, USA headquarters) 


+1 408-979-3945 


Support, Japan 


+81 22 449 3803 
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Special Notes 


The following notations highlight any key points and cautionary notes that may 
.appear in this manual. 


NOTE: These callouts note important or useful points in the text. 


CauTION! Used for situations that present minor hazards that may interfere with 
or threaten equipment/performance. 
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CHAPTER 1 Introduction 


What is LynxOS-178 v2.2.4 BETA? 
LynxOS-178 v2.2.4 BETA will hereon simply be referred to as LynxOS-178. 


LynxOS-178 includes kernel enhancements, new tool chains, debuggers, and 
Cross-Development Host support. 


Lynx Software Technologies, Inc. has been the premier developer of POSIX- 
conformant real-time operating systems. Our flagship product, called LynxOS, is 
in use in hundreds of thousands of installations where high reliability and hard 
real-time determinism are essential. LynxOS-178 is based on LynxOS and has the 
features necessary for safety-critical applications such as aviation, defense, 
medicine, along with other business-critical fields. Along with the operating 
system and the Development tools, Lynx Software Technologies can optionally 
provide the necessary artifacts to permit LynxOS-178 to be used in systems that are 
certifiable up to level A of the RTCA DO-178B standard. In addition, LynxOS-178 
provides the ability to run multiple levels of DO-178B criticality on the same 
platform. 


LynxOS-178 Development Environment 
LynxOS-178 uses the following for the Development Environment: 


* Host Platform: PC running Red Hat Enterprise Linux 6.2 64bit or 
Windows 7 64bit. 


* Target System: Usually purpose-built computers running a custom- 
configured Board Support Package (BSP) for that board. When the actual 
target systems are not yet available, development can be done using 
“reference platforms” (that is, commercially available computers for 
which a BSP already exists). Contact a Lynx Software Technologies 
representative for information about target platforms that are currently 
available. 
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Features of LynxOS-178 
LynxOS-178 provides the following features: 


UNIX-LIKE ENVIRONMENT — The LynxOS-178 Operating System is 
similar to UNIX. Applications use processes and threads, make system 
calls, and use device drivers. The product can run a shell on a serial port 
for a developer to interact directly with the target machine. It also has 
device drivers to permit mounting an external disk drive to facilitate 
testing and data capture 


POSIX-CONFORMANT INTERFACES — LynxOS-178 offers 
POSIX.1 conformance and also supplies all the services specified by 
POSIX 1.b (real-time extensions) and POSIX 1.c (threads extensions). 
The POSIX real-time and thread extensions are later additions to the 
original POSIX.1 standard, and they have extensive applicability for real- 
time and embedded systems. 


The real-time extensions include priority scheduling, real-time signals, 
clocks and timers, semaphores, message passing, shared memory, asynch 
and synch I/O, and memory locking. The threads extensions include 
specifications for thread creation, control, and cleanup; thread 
scheduling; thread synchronization; and signal handling. 


DO-178B LEVEL A CERTIFIED ARTIFACTS — LynxOS-178 contains 
a combination of certified and certifiable software and artifacts that allow 
developers to quickly produce and deploy safety-critical systems. 
LynxOS-178 artifact packages for the kernel and system services, 
including full DO-178B traceability through requirements, design, code, 
test, and test results are available as optional products. Please contact 
your Lynx Software Technologies sales representative to discuss the 
availability of DO-178B artifact packages for specific components. 


MATURE, STABLE, AND FULLY CERTIFIABLE — LynxOS, on 
which LynxOS-178 is based, is an embedded real-time Operating System 
that has been rigorously exercised through millions of deployments and is 
the foundation of multiple safety-critical systems that have been certified 
to DO-178B. 


HARD PARTITIONING OF TIME, MEMORY, AND RESOURCES — 
LynxOS-178 implements a time-slice scheduling algorithm that gives 
each partition fixed execution time so that the system can be 
deterministically safe. Additionally, the system allows multiple 
applications of differing criticality levels within partitions to execute, 
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completely isolated, on the same hardware resource. With LynxOS-178, 
each task runs protected in its own space for uncompromising reliability 
within a hard partitioned Virtual Machine, enabling easier application 
certification. 


* UPGRADABLE WITHOUT INVALIDATING CERTIFICATION — 
Mountable file systems and dynamically installed device drivers ease the 
certification of upgrades and enhancements. Applications and drivers are 
not required to be linked to the Operating System and can, therefore, be 
isolated, limiting recertification efforts for the full Operating System 
when only an application or driver needs modification. 


* ARINC 653-1 SUPPORT — LynxOS-178 conforms to the ARINC 653-1 
APEX Interface defined by the ARINC 653-1 standard, ensuring 
application portability, software reuse, and interoperability between 
embedded systems. LynxOS-178 provides the following system service 
groups in accordance with the ARINC 653-1 standard: Partition 
Management, Process Management, Time Mariagement, Interpartition 
Communication (Sampling Port Services and Queuing Port Services), 
Intrapartition Communication (Buffer Services, Blackboard Services, 
Semaphore Services, and Event Services), and Health Monitoring. 


+ FACE SUPPORT — This release contains enhancements to both ARINC 
and POSIX support in order to fully support the API requirements of the 
FACE 2.0/2.1 Safety Extended profile in Production Version. All of these 
APIs are also available in Development Version. 


+ NETWORKING SUPPORT IN THE DEVELOPMENT VERSION — 
The Development Version of LynxOS-178 includes the TCP/IP stack to 
enable development and debugging. TCP/IP and NFS include support for 
the following utilities and services: ping, rcp, rlogin, route, NFS 
client, ftpd, irshd, rlogind, rshd, and telnetd. 


NoTE: The TCP/IP stack is intended for use during software development. It is not 
to be used in a certified systems and is not partition-aware. 
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USER-SUPPLIED NETWORK STACK SUPPORT IN THE 
PRODUCTION VERSION — The user may supply their own driver that 
will implement the network stack as well as a UNIX domain datagram- 
based socket functionality. The Production Version kernel has hooks for 
user-supplied functions, and also a dummy driver (nul 1nux) is provided 
in the Production Version. 


Production Version LCS TCP/IP Stack. 


INTRAPARTITION COMMUNICATION USING UNIX DOMAIN 
SOCKETS — In the Development Version, both stream- and datagram- 
based sockets are supported. In the Production Version, stream-based 
sockets are supported by default and support for the rest depends on the 
user-supplied network stack. 


FATAL SIGNALCATCHING BY HEALTH MONITOR IS 
CONFIGURABLE IN THE DEVELOPMENT VERSION— By default, 
the fatal signals are not processed by the Health Monitor and the reaction 
of the system to such signals conforms with POSIX. By setting the 
HM_CATCH_FAULTS macro to | in the BSP specific uparam.h file, the 
system may be configured to catch the fatal signals using the Health 
Monitor. In the Production VERSION, fatal signals are always processed 
by the Health Monitor 


THREAD SAFE BSD LIBRARY — The libbsd library that provides 
network-related functions such as gethostbyname is thread-safe now 
and can be used in multithreaded applications without an additional 
synchronization. 


CONFIGURABLE TICK TIMER FREQUENCY — The tick rate can be 
configured by adjusting the TICKSPERSEC macro in the 
usr/include/conf.h file. By default, the rate is set to 1000 ticks per 
second. After changing the value, the kernel must be rebuilt. 
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Supported Host and Target Systems 


The LynxOS-178 v2.2.4 BETA Cross-Development software should be installed 
_on a supported Cross-Development Host. The following table provides a summary 
of the supported host and target configurations. 


Table 1-1: Supported Host and Target Configurations 


Supported Host Systems Supported Target Systems 


| Windows 7 Professional, SP1 (64-bit) | Freescale P3041 DS 
Freescale T2080 QDS 


Freescale T2080 RDB 


| Red Hat Enterprise Linux 6.2 (64-bit) | Freescale P3041 DS 
| Freescale T2080 QDS 
| | Freescale T2080 RDB 


About LynxOS-178 v2.2.4 BETA 
LynxOS-178 v2.2.4 BETA supports two versions: < 


. 2 eas 
+ Development Version 
* Production Version 


The Production Version of LynxOS-178 has a feature set that has complete| 
DO-178 artifacts and traceability for Level A certification of the LynxOS-178 
kernel and libraries. 


The Development Version (a superset of the Production Version) has additional 
features that assist in application development and debugging on LynxOS-178: 


* MORE KERNEL FEATURES — Try, ptrace, skdb, and CodeTEST 
hooks, etc. 


* SHELLS AND UTILITIES — bash, TFTP application, ps, gzip, high 
water mark utilities, and additional file system utilities such as 1s, cat, 
mkdir, copy, and rm, etc. 


* DEBUGGERS — Standard gdbserver for working with GDB. 
+ ADDITIONAL DEVICE DRIVERS — network interface drivers. 


These additional features do not have supporting DO-178B artifacts and are 
intended for use during development only. 
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Refer to the LynxOS-178 v2.2.4 BETA User's Guide for the sets of system calls that 
are supported in the Development Version and Production Version. 


LynxOS-178 Product Package 
The LynxOS-178 product package includes the following: 
* License Manager CD-ROM 


+ LynxOS-178 Open Development Environment for Linux (ODEL) 
Development Version CD-ROM 


* LynxOS-178 Open Development Environment for Linux (ODEL) 
Production Version CD-ROM 


+ LynxOS-178 Open Development Environment for Windows (ODEW) 
Development Version CD-ROM 


+ LynxOS-178 Open Development Environment for Windows (ODEW) 
Production Version CD-ROM 


+ LynxOS-178 Documentation CD-ROM 

* (Optional) LynxOS-178 Advanced Porting Kit CD-ROM 

+ (Optional) LynxOS-178 Sources CD-ROM 

+ (Optional) LynxOS-178 GNU Toolchain Source CD-ROM 
+ (Optional) LynxOS-178 Test Suite Source 

* (Optional) LynxOS-178 OpenGroup Test Sources 
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CD-ROM Contents for Binary Packages 


Table 1-2 lists the contents of the /lynx/flexlm-v1l.7/binaries/ directory 
on the License Manager CD-ROM. 


Table 1-2: License Manager CD-ROM Contents 


Directory Contents 
| /lynx/flexlm-v1l.7/binaries/ 
| <media_num>. license_linux32.tgz FlexLM v11.7 License Manager for 32 bits Linux 
system 
<media_num> vlicense linux64 .tgz FlexLM v11.7 License Manager for 64 bits Linux 
system 
<media_num>.license_win32.tgz FlexLM v11.7 License Manager for Windows 
system 
| 
<media_num>.license_sol.tgz FlexLM v11.7 License Manager for Solaris system 


Table 1-3 lists the contents of the /tar_images/ directory on the LynxOS-178 
ODEL Development Version CD-ROM, where <bsp_name> is the name of the 
Board Support Package (BSP). 


Table 1-3: LynxOS-178 ODEL Development Version CD-ROM Contents 


es : 
| Directory | Contents 


| Linux/Diskl1/InstData/VM/install.bin Linux Installer 


/tar_images/ 


'<media_n um>.cdk<host>.tar.gz | GNU toolchain and all other 
| Development Tools 


<media_num>. los 178_dev.tar.gz | System files (minus the RSC files) for 
| the PowerPC architecture with 
| debugging support 
<media_num>.bsp_<bsp_name>_dev.tar.gz BSP files for a target board in the 


| Development Version 
1 


<media_num>.1los178_rsc_dev.tar.gz System files included within the RSC | 
components for the Development 
Version 
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Table 1-3: LynxOS-178 ODEL Development Version CD-ROM Contents 


‘Directo i Contents 
ry 


<media_num>.libcrypt.tar.gz | Liberypt files 


Downloadable Images (KDIs) within 


| 

| <media_num>.demo_src.tar.gz | Sources for the demo Kernel j 
| 

| | LynxOS-178 | 


Table 1-4 lists the contents of the /tar_images/ directory on the LynxOS-178 
ODEL Production Version CD-ROM, where <bsp_name> is the name of the 
Board Support Package (BSP). 


Table 1-4: LynxOS-178 ODEL Production Version CD-ROM Contents 


Directory Contents 


/tar_images/ 


<media_num> -cdk<host>.tar.gz GNU toolchain and all other 
Development Tools 


| = ——— 
| <media_num>.1los178_pdn.tar.gz 


System files (minus the RSC files) for 
the PowerPC architecture with 
debugging support | 


<media_n um>. 108178 _rsc_pdn. tar. gz System files included within the RSC 
components for the Production Version 


| 
e| 
| 


<media_num>.bsp_<bsp_name>_pdn.tar.gz BSP files for a target board in the 
Production Version 
<media_num>.libcrypt.tar.gz Libcrypt files 
<medi a_num>. demo_s re.tar.gz — zm Sources for the demo Kernel - 
Downloadable Images (KDIs) within 
| LynxOS-178 
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Table 1-5 lists the contents of the /tar_images/ directory on the LynxOS-178 
ODEW Development Version CD-ROM, where <bsp_name> is the name of the 
Board Support Package (BSP). 


Table 1-5: LynxOS-178 ODEW Development Version CD-ROM Contents 


Directory Contents 
nn nr a a er 
/tar_images/ 


| 
| <media_num>.1os178_dev.tar.gz System files (minus the RSC files) for 
the PowerPC architecture with 


debugging support 


r : tats 

| <media_num>.1los178_rsc_dev.tar.gz System files included within the RSC | 
components for the Development 
Version 


<media_num>. cdkwin32.tar.gz | GNU toolchain and all other 
Development Tools 


<media_num>.bsp_<bsp_name>_dev.tar.gz BSP files for a target board in the 
Development Version 

<media_num>.libcrypt.tar.gz Liberypt files 

<media_num>. demo_s re.tar.gz Sources for the demo Kernel 
Downloadable Images (KDIs) within 
LynxOS-178 


Table 1-6 lists the contents of the /tar_images/ directory on the LynxOS-178 
ODEW Production Version CD-ROM, where <bsp_name> is the name of the 
Board Support Package (BSP). 


Table 1-6; LynxOS-178 ODEW Production Version CD-ROM Contents 


Directory Contents 


Windows/Disk1/InstData/VM/install.exe Windows Installer 


/tar_images/ 


<media_num>.10s178_pdn.tar.gz System files (minus the RSC files) for 
the PowerPC architecture with | 
debugging support i 
<media_num>.1o0s178_rsc_pdn.tar.gz System files included within the RSC 


components for the Production Version 
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Table 1-6: LynxOS-178 ODEW Production Version CD-ROM Contents 


Directory Contents 


<media_num>.cdkwin32.tar.gz GNU toolchain and all other 
Development Tools 


<media_num>.bsp_<bsp_name>_pdn.tar.gz BSP files for a target board in the 
Production Version 


<media_num>.libcrypt.tar.gz Liberypt files 
<media_num>.demo_src.tar.gz Sources for the demo Kernel 
Downloadable Images (KDIs) within 


LynxOS-178 


Table 1-7 lists the contents of the /tar_images/ directory on the LynxOS-178 
Test Suite Source. 


Table 1-7 nxOS-178 LynxOS-178 Test Suite Source CD-ROM Contents 

Directory Contents 
<media_num>.api_sockets_test.tar.gz API Sockets Test 
<media_num>. arinc653_test.tar.gz Arinc653 Test 
<media_num>.testdrivers src.tar.gz | Test Driver Source 
<media_num>.libgcc_test.tar.gz Libgec Test 
<media_num>.memdisk_test.tar.gz Memdisk Test 
<media_num>.tp_test.tar.gz Time Partitioning Test 
<media_n um>.rp_t est.tar.gz Resource Partitioning Test. 


Table 1-8 lists the contents of the /tar_images/ directory on the LynxOS-178 
OpenGroup Test Source. 


Table 1-8: LynxOS-178 OpenGroup Test Source CD-ROM Contents 


Directory | Contents 


<media_num>.opengroup test.tar.gz | Board Test Configuration 


} 7 
<media_num>.common:-src_tst_configuration. | OpenGroup Test Source 
tar.gz : 
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Table 1-9 lists the contents of the /tar_images/ directory on the LynxOS-178 
GNU Toolchain Source. 


Table 1-9: LynxOS-178 GNU Toolchain Source CD-ROM Contents 


3 a T ~] 
Directory | Contents 
<media_num>.toolchain_src.tar.gz | Toolchain Source Files | 
README.txt | Instructions for building the GNU. 

| toolchain 


Installation Procedures Summary 


The installation procedure is summarized below. Use these steps to prepare for 
installation and to begin the process. 


1. Install FLEXIm software and obtaining a license key. 


LynxOS-178 v2.2.4 BETA installation requires that you install FLEXIm 

software and obtain a license key by submitting the FLEXIm license key 

request form. Complete details on installing the Flexlm software and the 

procedure to obtain the license key are provided in the License + uenatatCoarsstree 
Management Software User s Guide. 


2. Perform one of the following options: 


a. Install the LynxOS-178 Binary Package using GUI Installer and install 
the LynxOS-178 v2.2.4 BETA Binary Service Pack. 


For LynxOS-178 in the Development Version, refer to “Installing the 
LynxOS-178 Development Version” on page 19. 


For LynxOS-178 in the Production Version, refer to “Installing the 
LynxOS-178 Production Version” on page 28. 


b. Build LynxOS-178 from Source Code by using the LynxOS-178 
v2.2.4 BETA Source Packages and the LynxOS-178 v2.2.4 BETA 
Service Pack Source. 


For LynxOS-178 in the Development Version, refer to “Building the 
LynxOS-178 Development Version” on page 38. 


For LynxOS-178 in the Production Version, refer to the “Building the 
LynxOS-178 Production Version” on page 39. 
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This section describes the installation procedure for the LynxOS-178 software 
components onto a Linux Host or onto a Windows Host. 


Installing the LynxOS-178 Development Version 


Overview 


Installation of these core components is required for the LynxOS-178 software. 
The core LynxOS-178 software components are: 


* The LynxOS-178 CDK — Includes the GNU toolchain, License 


Management software, and all other Development tools. 
Ue. 
* The LynxOS-178 Development Version — Incliides the LynxOS-178 
system files, RSC files, Libcrypt and BSP for a target board. 


yest 


The basic steps of the installation are as follows: 


1. Install the LynxOS-178 CDK, ODE, and BSP from the respective 
CD-ROMs by using the InstallAnywhere GUI Installer (for Linux Hosts 
and Windows Hosts). 


An overview of the installation steps is provided in the following 
sections. The information in those sections might also help some users to 
plan what their responses will be to certain installation prompts. 


NOTE: The figures shown in the following sections are based on the LynxOS-178 
Development Version installation. 


2. Runa setup script to enable LynxOS-178. 


3. Open a License Management session. 
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Linux Host Installation 


To install the LynxOS-178 onto the Linux Host, perform the steps described below. 


Note: The Ly nxOS-178 CDK package must be installed before the LynxOS-178 
Development Version package. Failure to install these components in the correct 
order can result in problems with LynxOS-178. 


1. Install the LynxOS-178 Development Version core components by using 
the InstallAnywhere GUI Installer. 


Insert the LynxOS-178 CDK CD-ROM (Linux Host) into the 
CD-ROM drive. Enter the following command to start LynxOS-178 
CDK installation: 


# sh <ci 


VM/insta 


mount _point>/Linux/Diskl/InstData/ \ 
bin 


This will open the Introduction window (see Figure 2-1). 


LynxOS-178 2.2.4 Development Version ODE for PowerPC (p3041rdb) 
Introduction 


InstallAnywhere will guide you through the installation of 
Lynx0S-178 2.2.4 Development Version ODE for PowerPC 
(P3041 rdb), 
Install. Set 
install Folder It is strongly recommended that you quit all programs before 
Irstaitacion Opnior continuing with this installation, 
Pre-Installation Summer Click the ‘Next’ button to proceed to the next screen. If you 
instaiing. want to change something on a previous screen, click the 
me ‘Previous’ button 


Install Cor 


You may cancel this installation at any time by clicking the 
‘Cancel button. 


Figure 2-1: LynxOS-178 v2.2.4 BETA for PowerPC — Introduction 
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ee ee 


Click Next to go to the License Agreement window. 


The License Agreement window appears (see Figure 2-2). 


we LynxOS-178 2.2.4 Development Version ODE for PowerPC (p3041rdb) 


Installation and Use of LynxOS-178 2.2.4 Development 
Version ODE for PowerPC (p30411rdb) Requires Acceptance 
of the Following License Agreement: 
Neau ngs —useU~ TT UNTSs Ayr eeMent are re rauET 
for reference purposes only and shall not be 
considered in construing or interpreting this 

mime Agreement. 


nstaltation Surat Should you have any questions about 
Installing. this Agreement, or if you desire to contact 


4 |Lynx Software Technologies Inc. for any reason, 
Install Come please visit our website at http://www. lynx. 
com/company/contact-us/ 


DOC-0114-02 
10-14-14 


@® (i accept the fer@s ot the Licehise Agreement 


Ido NOT accept the terms of the License Agreement 


os oe 


Figure 2-2: LynxOS-178 v2.2.4 BETA for PowerPC — License Agreement 


Read the displayed License Agreement completely by scrolling down 
and select the | accept the terms of the License Agreement radio button. 


Click Next to go to the Choose Install Set window 
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The Choose Install Set window is displayed. Figure 2-3 shows the 
dialog where the user can specify a custom install set of options that 
are available and will be installed with LynxOS-178. 

LynxOS-178 2.2.4 Development Version ODE for PowerPC (p3041rdb) x 


Choose install Set 


Install Set Custom 


 cDK 

M Devos 

M ssp 

Mirsc 
Installing @ Libcrypt 


Install Complete ‘ etic 
Description 


<Enter Product Feature description here -- do not forget to 
assign this Feature to desired Install Sets> 


tall 


= om 


Figure 2-3: LynxOS-178 v2.2.4 BETA for PowerPC — Choose Install Set 


Click Next to go to the Choose Install Folder window. 
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The Choose Install Folder window is displayed. The user can specify 
the name of the folder where LynxOS-178 will be installed. 
Figure 2-4 shows the window with the default installation folder as 


/usr/10s178/2.2.4. 


we LynxOS-178 2.2.4 Development Version ODE for PowerPC (p3041rdb) 


se Install Folder 


Where Would You Like to Install? 
[tusr/iosi78/2.2.4 


| Restore Default Folder || Choose... | 
e Installation. 


Surana, 


IB cance | | erevous vex il 


Figure 2-4: LynxOS-178 v2.2.4 BETA for PowerPC — Choose Install Folder 


NOTE: The absolute path name is required here. Any relative path 
name can result in installation problems. 


Click Next to go to the Choose Install Option window. 
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The Choose Install Option window is displayed. Figure 2-5 shows the 
window that appears after the default installation folder 
/usr/los178/2.2.4/ has been selected. 


ge LynxOS-178 2.2.4 Development Version ODE for PowerPC (p3041rdb) x 


e Installation Option 


Folder? 


Installation Surmimar 


fee you want to create link /usr/los178/2.2.4 to the Ins! 
| 
| 


Installing. 
Install Cor 


© Don't Create 


all anderen 


Cancel, 


Figure 2-5: LynxOS-178 v2.2.4 BETA for PowerPC — Choose Installation Option 


The user can elect to either Create or Don’t Create a link to the /nstall 
Folder that was specified in the previous window. 


Click Next to go to the Pre-Installation Summary window. 
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The Pre-Installation Summary window is displayed. Figure 2-6 
displays the installation choices that have been made by the user. 


w LynxOS-178 2.2.4 Development Version ODE for PowerPC (p3041rdb) x 
Pre-Installatior: Summary 


Please Review the Following Before Continuing: 


Product Name: 
LynxOS-178 2.2.4 Development Version ODE for 
PowerPC (p3041rdb) 


Install Folder: 
/usr/los178/2.2.4 
instanting 
instal Corplete Disk Space Information (for Installation 
Target): 
Required: 149,477,703 bytes 
Available: 32,562,839,552 bytes 


[conc] = = 


Figure 2-6: LynxOS-178 v2.2.4 BETA for PowerPC — Pre-Installation Summary 


This window allows the user to review information such as Product 
Name, Install Folder, and Disk Space Information before continuing 
the installation process. 


Click Install to proceed with installation. 
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Windows Cross-Development Installation 


The LynxOS-178 ODEW CD-ROM contains the CDK, RSC, and ODE software 
components. These components are installed at the same time during the GUI 
Installer installation. 


NoTE: If Cygwin is installed and mounted on the Windows | Host, the Cygwin 
mounted directories should be un-mounted before installing LynxOS-178 v2.2.4 


BETA. 


NOTE: Installation of an ODEW onto a disk drive other than C is not supported for 
the Windows Host. It is important to install the ODEW onto the C disk drive. 


1. 


Install the LynxOS-178 Development Version core components by using 
the InstallAnywhere GUI Installer. 


Insert the LynxOS-178 Development Version ODEW CD-ROM into the 
CD-ROM drive. If Autorun is enabled on the system, the Introduction 
window will come up automatically. If Autorun:is.disabled, start the 
installation by double-clicking the Instail-InstallAnywhere self Extractor 
Macrovision icon under the 
<cedrom_drive>:Windows\Disk1\InstData\vM directory. 


For the LynxOS-178 ODEW CD-ROM, specify whether the software is 
being installed for a single user or for multiple users. 


The user can go through the installation steps as instructed by the 
InstallAnywhere GUI Installer prompt. 


Before using LynxOS-178 v2.2.4 BETA to develop applications, you 
must perform the following: 


- Double click the LynxOS-178 v2.2.4 BETA icon on the desktop to 
launch the bash shell. 


- Change to the directory where the LynxOS-178 CDK is installed and 
set LynxOS-178. For example: 


$ cd /usr/los178/2.2.4/ppc_dev 
$ . SETUP.bash 
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Refer to the LynxOS-178 v2.2.4 BETA Users Guide for more information 
on the SETUP script. 
; NOTE: If you did not already install and configure the FlexLM software, you must 
complete the License Management Installation Process before you proceed. Refer 
to the License Management Installation Guide for complete details. 


3. Open a License Management session. Define the license data file. For 
example: 


$ export LM_LICENSE_FILE=c:/flexlm/ \ 
v11.7/WIN32/license.dat 


To start the Session Manager, enter the following: 


$ cd $ENV_PREFIX 
$ lwsmgr & 


NOTE: The above set of commands opens the License Management session info 
window. The License Management session will run while this window is open. 
Closing the License Management info window stops the License Management 
session. 
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Installing the LynxOS-178 Production Version 


Overview 
Installation of these core components is required for the LynxOS-178 Production 
Version. These core LynxOS-178 software components are: 


+ The LynxOS-178 CDK — Includes the GNU toolchain, License 
Management software, and all other Development tools. 


+ The LynxOS-178 RSC Production Version — Includes system files in the 
RSC components. 
+ The LynxOS-178 Production Version ODE (ODEL for Linux Hosts and 


ODEW for Windows Hosts) — Includes the LynxOS-178 system files, 
Libcrypt, and BSP for the target board. 


The basic steps of the installation are as follows: 


1. Install LynxOS-178 CDK, RSC, ODE, and BSP from their respective 
bh adecevil CD-ROMs by using the InstallAnywhere GUI Installer (for Linux and 
Windows Hosts) or Unix-like command line interface. 


i) 


Run a setup script to enable LynxOS-178. 


3. Open a License Management session. 


Linux Production Version Installation 


To install the LynxOS-178 Production Version onto the appropriate host, perform 
the steps described below. 


Note: The LynxOS-178 CDK package must be installed before the LynxOS-178 
Development Version RSC and ODEL packages. Failure to install these 


1. Install the LynxOS-178 Development Version core components by using 
the InstallAnywhere GUI Installer. 


Insert the LynxOS-178 CDK CD-ROM (Linux Host) into the CD-ROM 
drive. Enter the following command to start LynxOS$-178 Production 
Version CDK installation. 
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# sh <cdrom_mount_point>/Linux/Diskl/InstData/ \ 
vM/install.bin 


After LynxOS-178 CDK installation completes, insert the LynxOS-178 
Production Version ODEL CD-ROM into the CD-ROM drive. Enter the 
following command: 


# sh <cdrom_mount_point>/Linux/Diskl/InstData/ \ 
VM/install.bin 


Insert the LynxOS-178 Production Version ODEL CD-ROM into the 
CD-ROM drive. Enter the following command: 


# sh <cdrom_mount_point>/Diskl/InstData/Linux/ \ 
VM/install.bin 


The user can now examine the LynxOS-178 Production Version 
installation steps as instructed by the InstallAnywhere GUI Installer. 


2. Before using LynxOS-178 v2.2.4 BETA to develop applications, set 
LynxOS-178 with one of the two SETUP scripts: 


- Forthe bash shell: 

$ . SETUP.bash vet ecoken inate eel 
- For C shell: 

% source SETUP.csh 


Refer to the LynxOS-178 v2.2.4 BETA User s Guide for more information 
on these setup scripts. 


NOTE: If you did not install and configure the FLEXIm software already, you must 
complete it before you proceed to the next step. Refer to License Management 
Installation Guide for complete details. 


3. Open a License Management session. Define the license data file. For 
example: 


$ export LM_LICENSE_FILE=/usr/local/flexlm/ \ 
vll.7/linux64/license.dat 


To start the Session Manager, enter the following: 


$ cd $ENV_PREFIX 
$ lwsmgr 


Once the Session Manager is started, the user can start using the protected software 
tools. 
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Windows Cross-Development Installation 


Note: If Cygwin is installed and mounted on the Windows Host, the Cygwin 
mounted directories should be un-mounted before installing LynxOS-178 v2.2.4 
BETA. 


NOTE: Installation of an ODEW onto a disk drive other than C is not supported for 
the Windows Host. It is important to install the ODEW onto the C disk drive. 


The LynxOS-178 ODEW Production Version CD-ROM contains the CDK, RSC, 
Liberypt, and (ODEL for Linux Hosts and ODEW for Windows Hosts) software 
components. These components are installed at the same time during the GUI 
Installer installation. 


1. Install the LynxOS-178 Production Version core components by using the 
InstallAnywhere GUI Installer. 


Insert the LynxOS-178 Production Version ODEW CD-ROM into the 
CD-ROM drive. If Autorun is enabled on the system, the Introduction 
window will come up automatically. If Autorun is disabled, start the 
installation by double-clicking the Install InstallAnywhere self Extractor 
Macrovision icon under the 
<cdrom_drive>:Windows\Disk1\InstData\vM directory. 


User can go through the installation steps as instructed by the 
InstallAnywhere GUI Installer. 


2. Before using LynxOS-178 v2.2.4 BETA to develop applications, you 
must perform the following: 


- Double click the LynxOS-178 v2.2.4 BETA icon on the desktop to 
launch the bash shell: 


Change to the directory where the LynxOS-178 CDK is installed and set 
LynxOS-178. For example: 


$ cd /usr/los178/2.2.4/ppc_dev 
$ . SETUP.bash 


- Refer to the LynxOS-178 v2.2.4 BETA User s Guide for more 
information on these setup scripts. 
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NOTE: Installing the Development Version and the Production Version into the 


. same location, and then uninstalling one of them will remove Cygwin. 


Note: If you did not install and configure the FLEXIm software already, you must. 
complete it before you proceed to the next step. Refer to the License Management 
Installation Guide for complete details. 


3. Open a License Management session. Define the license data file. For 
example: 


$ export LM_LICENSE_FILE=c:/flexlm/ \ 
v11.7/win32/license.dat 


To start the Session Manager, enter the following: 


$ cd SENV_PREFIX 
$ lwsmgr & 


NOTE: The above set of commands opens the License Management session info 
window. The License Management session is run while this window is open. 
Closing the License Management info window stops the License Management 
session. 
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From a Linux Host 
To uninstall LynxOS-178 from a Linux host, enter the following: 


# sh 
<install_folder>/.IA_LynxOS_224 <comp>_<arch>_<mode>/ \ 
UninstallData/Uninstall 


where <install_folder> is the install folder, <comp> is the short name of 
LynxOS-178 installation CD-ROM (for example, ODE), <arch> is the target 
architecture (ppc), and <mode> is the LynxOS-178 version (dev, pdn or all). 


NOTE: The .CommonComponents directory in the installation directory may not 
be deleted after uninstalling any single installed project. Please remove it manually, 
after the uninstallation completes. 


From a Windows Host 

To uninstall LynxOS-178 from a Windows host, perform the following steps: 
1. From the Windows Control Panel, select Add/Remove Programs. 
2. Select the LynxOS-178 software. 


3. Select Change/Remove. 


NOTE: Some files are not removed during uninstalling. Remove these files 
manually. 


Note: After uninstalling Libcrypt_binary or LCS_binary, these components 
remain in the list of Add or Remove Programs. Please remove these components 
from Add or Remove Programs using the Change/Remove button. 
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This chapter describes the contents of the LynxOS-178 Source package, the 
process of installing LynxOS-178 sources, and how to build the Development 
Version and Production Version of LynxOS-178 from source. 


LynxOS-178 Source Package Contents 
The LynxOS-178 source package includes the following: 


+ LynxOS-178 OSS CD-ROM 
+ LynxOS-178 Advanced Porting Kit CD-ROM 


CD-ROM Layout 


Table 3-1 lists the contents of the /tar_images/ directory on the LynxOS-178 
OSS CD-ROM. 


Table 3-1: LynxOS-178 OSS CD-ROM Contents 


Directory Contents | 
/tar_images/ 


| <media_num>.1los178_src.tar.gz Sources for system files (minus RSC 
files) for the PowerPC architecture 


| <media_num>.1los178_rsc_src.tar.gz Sources for system files included in the 
RSC components for the PowerPC 
architecture 


<media_num>.tcpip_src.tar.gz Sources for TCP/IP stack 
<media_num>.nfs_src.tar.gz Sources for NFS 
<media_num>.libcrypt_src.tar.gz Sources for Liberypt 
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Table 3-2 lists the contents of the /tar_images/ directory on the LynxOS-178 
Advanced Porting Kit CD-ROM, where <bsp_name> is the name of the Board 
Support Package and <csp_name> is the name of the CPU Support Package 


(CSP). 


Table 3-2: LynxOS-178 Advanced Porting Kit CD-ROM Contents 


| Directory 


LynxOS-178 v2.2.4 BETA Board Support Guide 


Contents 


Documentation that describes the 
Board Support Guide 


| LynxOS-178 v2.2.4 BETA Advanced Porting Kit 
Guide 


Documentation that describes the 
Advanced Porting Kit Guide 


/tar_images/ 


<media_num>.<bsp_name>_src.tar.gz 


Sources for BSP files placed on a 
target board 


| <media_num>.drm_src.tar.gz 


DRM sources 


<media_num>.csp_src_<csp_name>.tar.gz 


PowerPC CSP and family of source 
files for a specified CSP 


<media_num>.cinit_common_src.tar.gz 


Common source files for CINIT 


<media_num>.cinit_<bsp_name>_src.tar.gz 


CINIT source files for the BSP 


<media_num>.hm_src.tar.gz 


Health Monitor sources 
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Installing LynxOS-178 Sources 


This section describes the installation procedure for the LynxOS-178 source files 
- Linux Host. 


An outline for the basic steps of the installation are as follows: 
1. Create the installation directory. 


2. Extract the installation files for the OSS and PKT from their respective 
CD-ROMs. 


3. Runa setup script to enable LynxOS-178. 


4. Open a License Management Session. 


NOTE: Installing the LynxOS-178 sources requires root privileges. 


It is critical to create separate installation directories for the Development Version 
and the Production Version builds. 


The instructions below assume that the /home/10s178/dev-build directory is 
used for building the Development Version and that the /home /10s178/pdn- 
build directory is used for building the Production Version. 


ee ee 


The LynxOS-178 sources MUST be installed in the order defined. Failure to install 
these components in the correct order can result in problems with building 
LynxOS-178. 


Perform the following steps in the exact order defined below: 


1. Create a directory for the LynxOS$-178 source installation by issuing the 
following command: 


# mkdir -p /home/los178/dev-build/ 
2. Install the LynxOS-178 OSS: 


- Insert the LynxOS-178 OSS CD-ROM into the CD-ROM drive and 
mount it. 


- Change to the LynxOS-178 installation directory: 
# cd /home/1los178/dev-build/ 


- Enter the following commands to extract the LynxOS-178 OSS tar 
files using the tar command: 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
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<media_num>.1los178_src.tar.gz 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.1os178_rsc_src.tar.gz 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.tcpip_src.tar.gz 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.nfs_src.tar.gz 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.libcrypt_srce.tar.gz 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.cdk<host>.tar.gz 
where <media_num> is an assigned unique number. 


- Unmount the LynxOS-178 OSS CD-ROM and remove it from the 
CD-ROM drive. 


3. Install the LynxOS-178 Advanced Porting Kit: 


- Insert the LynxOS-178 Advanced Porting Kit CD-ROM into the 
CD-ROM drive and mount it. 


- Change to the LynxOS-178 installation directory: 
# cd /home/los178/dev-build/ 
- Extract the BSP sources by entering the following commands: 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.csp_src_<csp_name>.tar.gz 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.drm_src.tar.gz 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.bsp_src_<bsp_name>.tar.gz 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.cinit_<bsp_name>_src.tar.gz 


‘# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.hm_src.tar.gz 
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where <media_num> is an assigned unique number, <bsp_name> is 
the name of the Board Support Package and <csp_name> is the name 
of the CPU Support Package. 

LynxOS-178 sources are now installed. 


- Unmount the LynxOS-178 Advanced Porting Kit CD-ROM and 
remove it from the CD-ROM drive. 


4. Install the LynxOS-178 CDK: 


- Insert the LynxOS-178 <host>CDK CD-ROM into the CD-ROM 
drive and mount it. 


- Change to the LynxOS-178 installation directory and extract the CDK 
using the following commands: 


# cd /home/1los178/dev-build/ 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.cdk<host>.tar.gz 


- Unmount the LynxOS-178 <host>CDK CD-ROM and remove it 
from the CD-ROM drive. 


5. Insert the LynxOS-178 Linux (ODEL) Development Version CD-ROM 
into the CD-ROM drive and mount it. 


- Change to the LynxOS-178 installation directory and extract the useful 
library files using the following commands: 


# cd /home/losi78/dev-build/ 


# tar -xvzpf /mnt/cdrom/tar_images/ \ 
<media_num>.1os178_dev.tar.gz./sys/miscgcc 


6. Before using LynxOS-178 sources to build binaries, users must setup 
LynxOS-178 with one of two SETUP scripts: 


- Forthebash shell: 
$ . SETUP.bash 
- For Cshell: 
% source SETUP.csh 


Refer to the LynxOS-178 v2.2.4 BETA Users Guide for more information on these 
setup scripts. Ensure that the License Management Session has been installed. 
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Building the LynxOS-178 Development Version 


After the sources have been installed, perform the following steps to build the 
LynxOS-178 Development Version: 


1. Change to the LynxOS-178 Development Installation Directory: 
$ cd /home/los178/dev-build 


2. Modify the following entry in the ENVIRONMENT file to read as shown 
below. 


DEVELOPMENT=yes 
3. Enable LynxOS-178 by using the SETUP script: 
$ . SETUP.bash 
4. Open a License Management session. 
- On the Linux Hosts: 
$ lwsmgr 
- Onthe Windows Host: 
$ lwsmgr & 
5. Execute the make install command: 


$ make install 
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Building the LynxOS-178 Production Version 


Assuming the LynxOS-178 sources have been installed in the 
- /nome/1os178/pdn-build directory (separate from the Development Version 
build), perform the following steps to build the LynxOS-178 Production Version: 


1. Change to the LynxOS-178 Production Version build directory: 
$ cd /home/1los178/pdn-build 


2. Modify the following entry in the ENVIRONMENT file to read as shown 
below. 


DEVELOPMENT=no 
3. Enable LynxOS-178 by using the SETUP script: 
$ . SETUP.bash 
4. Open a License Management session: 
- On the Linux Host: 
$ lwsmgr 
- Onthe Windows Host: 
$ lwsmgr & 
5. Execute the make install command: 


$ make install 
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